Put this in your html: <img src=http://machine.edu/path-to-cgis/counter.acgi?user/searchKey>
Where machine.edu, is your WWW machine. Path-to-cgis is where you keep your cgis in the WebStar folder. User is a user's name who's page you are counting (one word). searchKey is a unique key to the user's page you want counted (one word). (i.e. if you are the page you include the counter in is the index.html, you might have this as your cgi arguments: "grgcombs/index" ... where grgcombs is the user, and index is the pageKey)
Gotta have a resource editor, ala Resourcer or ResEdit to edit any machine specifics. Here's all your features and nifties and what they do:
If you are wanting to change the digit gifs, you can do so, just by replacing all the gifs in the DigitDir directory with files of the same names. About the boo.gif, it's an access denied gif. It's height (Y) in pixels should be the same as the height of your digit gifs. (right now it's 15x by 20y). If you do change the gifs, and the dimensions of them are changed, you need to open up the cgi with your resource editor, and go to the STR# resources. Open up resource 129, and the first string is X, the second is Y. Just type in you gifs dimensions in pixels.
If you don't want anyone to add your counter to their page from a remote site, ala "Counter Terrorism", I've set up a STR# resoure 128, that allows you to put up to 50 restriction strings (50 is just the max i have in the source code, if you get the source from me, you can change this in the counter2.h).
For example: I don't want anyone not on our WWW server or anyone not in our building domain using my counter, so I take my web server address, and put it in the first string of STR# 128 (www.edb.utexas.edu). And just it doesn't get the actual name of the address, I put the building ip number (128.83.243) in the second string of STR# 128. This also allows me to test my cgi from other computers in the building, i move around alot.
If I wanted it so that only myself could use it, I could make it so that only URLs containing my name are allowed by adding "grgcombs" to the 3rd string of STR# 128 (as long as i have a grgcombs subdirectory), so now "http://uts.cc.utexas.edu/~grgcombs/" will be allowed access, even though it's not in www.edb.utexas.edu, or even in the 128.83.243 ip group.
If you didn't understand any of that, when i release the real version of the cgi, i'll have better documentation, or you could just ask for assistance ;-)
To keep the CGI from quitting after 10 minutes of inactivity, all you have to do is put an alias of the cgi in the startup items folder. The CGI will only auto-quit if it was started up by an AppleEvent coming from WebStar or ListStar. It will also not auto-quit if you double click it in the finder...
**************
Things-To-Do:
**************
1. Make a preferences dialog to contain specifics like Gif Image size, and Restrictions, instead of having to edit the resources.
2. Port source over to MacToolBox calls from ANSI C, thus using FileManager.
3. Rewrite this crappy documentation.
********* IMPORTANT-READ-ME *********
The DigitDir folder must be inside the same folder as the counter.cgi.
All counter data folders must be inside the same folder as the counter.cgi.
Any changes to the digit gif size must be represented in the gif size resources as documented above.
If you have any questions, don't hesitate to contact me:
Gregory S. Combs
grgcombs@mail.utexas.edu
*********
SPECIAL THANKS GO TO:
Stephen Tallent for the groovy cgi icon.
Grant Neufeld for all his CGI Framework updates and helpful work on returning binary data to WebStar.
Daaron Dwyer for helping me with the Preferences Dialog box (not finished yet.)
Thanks to all the above, and to Chuck Shotton, Ian Bell, Nathan Tableman, and the guy I only know as "Martin", for helping in the development stages of the application.
